#http://www.jianshu.com/p/4eefb16d83e3
# Sets the minimum version of CMake required to build the native
# library. You should either keep the default value or only pass a
# value of 3.4.0 or lower.

cmake_minimum_required(VERSION 3.4.1)

# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds it for you.
# Gradle automatically packages shared libraries with your APK.

add_library( # Sets the name of the library.
             native-lib

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s).
             # Associated headers in the same location as their source
             # file are automatically included.
             src/main/cpp/native-lib.cpp


              )

#STATIC：静态库，是目标文件的归档文件，在链接其它目标的时候使用。
#SHARED：动态库，会被动态链接，在运行时被加载。
#MODULE：模块库，是不会被链接到其它目标中的插件，但是可能会在运行时使用dlopen-系列的函数动态链接。


# Specifies a path to native header files.
#include_directories(src/main/cpp/include/)
#include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])

# Searches for a specified prebuilt library and stores the path as a
# variable. Because system libraries are included in the search path by
# default, you only need to specify the name of the public NDK library
# you want to add. CMake verifies that the library exists before
# completing its build.

#这个方法与我们要创建的so库无关而是使用NDK的Apis或者库，默认情况下Android平台集成了很多NDK库文件，所以这些文件是没有必要打包到apk里面去的。
#直接声明想要使用的库名称即可（猜测：貌似是在Sytem/libs目录下）。在这里不需要指定库的路径，因为这个路径已经是CMake路径搜索的一部分。如示例中使用的是log相关的so库。
#log-lib
#这个指定的是在NDK库中每个类型的库会存放一个特定的位置，而log库存放在log-lib中
#log
#指定使用log库
find_library( # Sets the name of the path variable.
              log-lib

              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )

# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in the
# build script, prebuilt third-party libraries, or system libraries.
#如果你本地的库（native-lib）想要调用log库的方法，那么就需要配置这个属性，意思是把NDK库关联到本地库。
target_link_libraries( # Specifies the target library.
                       native-lib

                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )



#拓展之构建NDK源代码

#NDK 还以源代码的形式包含一些库，您在构建和关联到您的原生库时需要使用这些代码。您可以使用 CMake 构建脚本中的 add_library() 命令，
#将源代码编译到原生库中。要提供本地 NDK 库的路径，您可以使用 ANDROID_NDK 路径变量，Android Studio 会自动为您定义此变量。
#以下命令可以指示 CMake 构建 android_native_app_glue.c，
#后者会将 NativeActivity 生命周期事件和触摸输入置于静态库中并将静态库关联到 native-lib：
#app-glue
#仍然是自定义库的名称

#ANDROID_NDK
#这个是Android Studio已经定义好的变量，可以直接使用它指定的是NDK源代码的根目录。
#add_library( app-glue
#             STATIC
#             ${ANDROID_NDK}/sources/android/native_app_glue/android_native_app_glue.c )


# You need to link static libraries against your shared native library.
#target_link_libraries( native-lib app-glue ${log-lib} )



#拓展之使用第三方so库
#首先，我们告诉脚本我们只需要导入so库，不需要构建操作
#add_library( imported-lib
#             SHARED
#             IMPORTED )
#IMPORTED
#表示只需要导入，不需要构建so库。

#set_target_properties(target1 target2 ...
#                      PROPERTIES prop1 value1
#                      prop2 value2 ...)

#举例：
#set_target_properties(
#                      imported-lib // so库的名称
#                      PROPERTIES IMPORTED_LOCATION // import so库
#                      libs/libimported-lib.so // so库路径
#)

